IBM Books

Using and Configuring Features Version 3.4


Configuring and Monitoring Web Server Cache

This chapter describes how to configure Web Server Cache feature and use the Web Server Cache monitoring commands. It contains:


Configuring the Web Server Cache

Web Server Caching must be used with Network Dispatcher. Before you use Web Server Cache the first time you must:

  1. Access Network Dispatcher in talk 6 from the Config> prompt using the feature ndr command.
  2. Enable executor
  3. Add a cluster
  4. Add a port
  5. Add one or more servers.

Then you can use the configuration and monitoring commands to alter the Web Server Cache environment.
Note:While the Network Dispatcher changes done via Talk 6 change the current running configuration, the changes for the Web Server Cache do not change the current running configuration unless explicitly activated via the activate command in Talk 6 or in Talk 5 feature Webc. The exception to this is if the cluster/port for an HTTP Proxy is removed via Talk 6 feature NDR it will cause the HTTP proxy for the Web Server Cache to also be removed from the current running configuration.

Example:

Config>f ndr
NDR Config>enable executor
NDR Config>add cluster
Cluster Address [0.0.0.0]? 113.3.1.10
FIN count [4000]? 
FIN time out [30]? 
FIN stale timer [1500]? 
Cluster 113.3.1.12 has been added.
Fincount has been set to 4000 for cluster 113.3.1.10
Fintimeout has been set to 30 for cluster 113.3.1.10
Staletimer has been set to 1500 for cluster 113.3.1.10
NDR Config>add port
Cluster Address [0.0.0.0]? 113.3.1.10
Port number [80]? 
Port type (tcp=1, upd=2, both=3) [3]?
Max. weight (0-100) [20]? 
Only one pftp port per cluster allowed 
Port mode (none=0, sticky=1 pftp=2 cache=3 extcache=4) [0]? 3
Do you want a new cache partition? [Yes]: 
Enter cache partition [0]?
Default server TCP connection timeout (Range 5-240 seconds) [120]? 
Default client TCP connection timeout (Range 5-240 seconds) [120]? 
Maximum partition size (1-4095 megabytes or 0 for no limit) [0]? 
Maximum number of objects (1-100000 or 0 for no limit) [0]? 
Maximum object size (512-300000 bytes or 0 for no limit) [0]? 
Do you want the cache enabled upon reboot? [Yes]: 
 
Default cache purge interval (1-720 minutes or 0 to disable) [10] 
Enable transparent caching? [Yes]: 
Check cache control headers? [Yes]: 
Cache images? [Yes]: 
      Default expiration time for images
              (1-10080 minutes or 0 for no expiration) [60]? 
Cache non-image static objects? [Yes]: 
      Default expiration time for non-image static objects
              (1-10080 minutes or 0 for no expiration) [60]? 
URL mask to identify dynamic objects [*/cgi*]? 
Cache dynamic objects? [No]: 
Do you want to add a URL mask? [No]: 
 
Cache partition number 1 has been successfully created.
Requested port has been added to cluster 113.3.1.10
Maxweight has been set to 20 for port 80 in cluster 113.3.1.10
NDR Config>add server
Cluster Address  [0.0.0.0] ? 113.3.1.10 
Port number  [80] ? 80 
Server Address  [0.0.0.0] ? 113.1.2.0   
Server weight   [20] ? 
Server state (down=0, up=1)  [1] ? 
Server 113.1.2.0 has been added to the requested port(s) of cluster 113.3.1.10 
Weight of server 113.1.2.0 has been set to 20 in port 80 of cluster 113.31.10
Server 113.1.2.0 has been set up.
NDR Config> exit
 

The following lists the example parameters specific to the Web Server Cache and their descriptions.

cluster-address
Specifies the IP address for the cluster.
Note:Cluster IP Addresses are assumed to be on the same logical subnet as the previous hop router (IP router), unless Cluster Address Advertising is used for the cluster.

Valid Values: Any valid IP address

Default Value: 0.0.0.0

FIN-count
Specifies the number of connections that must be in FIN state before the executor tries to remove the unused connection information from the Network Dispatcher database after FIN-timeout or Stale-timer has elapsed.

Valid Values: 0 to 65535

Default value: 4000

FIN-timeout
Specifies the number of seconds, that a connection has been in the FIN state, after which the executor tries to remove the unused connection information from the Network Dispatcher database.

Valid Values: 0 to 65535

Default Value: 30

Stale-timer
Specifies the number of seconds, that a connection has been inactive, after which the executor tries to remove a connection's information from the Network Dispatcher database.

Valid Values: 0 to 65535

Default Value: 1500

port#
Specifies the port number of the protocol for this cluster.

Valid Values: 1 to 65535

Default Value: 80

port-type
Specifies the types of IP traffic that can be load balanced on this port. Supported types are:

Valid Values: 1, 2, 3

Default Value: 3

max-weight
Specifies the maximum weight for servers on this port. This affects how much difference there can be between the number of requests the executor will give each server.

Valid Values: 0 to 100

Default Value: 20

port-mode
Specifies whether the port will feed all requests from a single client to a single server (known as sticky), use passive ftp (pftp), use Web Server Cache (cache), feed an external scalable cache array (extcache), or use no particular protocols on this cluster (none).

Valid Values: 0 - 4, where:

Default value: 0

Do you want a new cache partition?
Specifies whether you want to use an existing cache partition or a new partition.

Valid Values: Yes or No

Default Value: Yes

Enter cache partition
Specifies the number of the existing cache partition to be used.

Valid Values: Any existing cache partition number

Default Value: 0

Default server TCP connection timeout
Specifies the time before a server connection expires.

Valid Values: 5 to 240 seconds

Default Value: 120 seconds

Do you want to modify cache partition?
Allows you to modify the configuration of an existing cache partition.

Valid Values: Yes or No

Default Value: No

Default client TCP connection timeout
Specifies the time before a client connection expires.

Valid Values: 5 to 240 seconds

Default Value: 120 seconds

Maximum partition size
Specifies the maximum amount of memory to be allocated to this cache partition. If this value exceeds the amount of memory currently available, it will be ignored and no maximum partition size will be imposed.

Valid Values: 1 to 4095 Megabytes or 0 (no maximum)

Default Value: 0 (no maximum)

Maximum number of objects
Specifies the maximum number of objects that can be stored in a cache partition. If the user enters a 0, the cache partition will be limited only by the amount of memory available to the partition.

Valid Values: 1 to 100000 or (no limit)

Default Value: 0 (no limit)

Maximum object size
Specifies the maximum size for objects to be included in the cache. Objects exceeding this maximum size will never be included in the cache. If the maximum object size is changed after the cache has been populated, it is possible that objects already in the cache may temporarily exceed the defined maximum.

Valid Values: 512 to 300000 bytes or 0 (no maximum size)

Default Value: 0 (no maximum size)

Do you want the cache enabled upon reboot?
Specifies whether a cache partition should be enabled automatically or upon explicit user request. Cache partitions that are set for immediate enabling are automatically enabled when the 2212 is rebooted. Cache partitions that are not set for immediate enabling will remain available, but in the disabled state until the user enables the partition from the Web Server Cache console in talk 5.

Valid Values: Yes or No

Default Value: Yes

Default cache purge interval?
Specifies the default cache purge interval.

Valid Values: 1 to 720 minutes or 0 (disable)

Default Value: 10 minutes

Enable transparent caching?
Specifies whether server responses for objects not found in the cache (cache misses) will automatically be cached. The alternative is to use the ECCP to manipulate the cache.

Valid Values: Yes or No

Default Value: Yes

Check cache control headers?
Allows a server to specify to the Web Server Cache whether or not the response is eligible to be cached.

Valid Values: Enabled or Disabled

Default Value: Disabled

Cache images?
Specifies whether image files (*.gif or *.jpg) are to be cached.

Valid Values: Yes or No

Default Value: Yes

Default expiration time for images

Valid Values: 1 to 10080 minutes, or 0 (none)

Default Values: 60 minutes

Cache non-image static objects?
Specifies whether non-image static data (files that do not contain */cgi* and files that do not end in .jpg or .gif) are to be cached.

Valid Values: Yes or No

Default Value: Yes

Default expiration time for non-image static objects

Valid Values: 1 to 10080 minutes, or 0 (none)

Default Values: 60 minutes

URL mask to identify dynamic objects
Specifies the URL mask used to identify dynamic objects.

Valid Values: any URL mask

Default Value: */cgi*

Cache dynamic objects?
Specifies whether to cache dynamic objects. Dynamic objects are objects that have been constructed by the server when the object is requested and are reconstructed for each new request whether the data has changed or not.

Valid Values: Yes or No

Default Value: No

Do you want to add a URL mask?
Specifies a new URL mask to be added to the cache. URL masks allow the user to include or exclude individual objects or groups of objects by their Universal Resource Locator (URL).

Valid Values: i or e

Default Value: i

Wildcard characters can be used when specifying a URL mask. Wildcards can be used when configuring Network Dispatcher for the Web Server Cache or when using the add or modify url command from the f webc prompt. The characters used as wildcards are an * (asterisk) or a # (number sign). Wildcards can be used in any position as a part of the URL.

The * represents any number of characters, including zero characters, as a part of that URL:

Example: *abc.html would filter the following URL masks.

abc.html
finabc.html
defchtjqsprabc.html

The # represents any single character.

Example: ab#.html would filter the follow URL masks.

abc.html
abf.html
abo.html

The following example applies when port mode 3 (cache=3) is selected and a new cache partition is not being added.

NDR Config>add port                                                
Cluster Address  [0.0.0.0] ? 113.3.1.11                               
Port number  [80] ?                                                   
Max. weight (0-100)  [20] ?                                           
Only one pftp port per cluster allowed                              
Port mode (none=0, sticky=1 pftp=2 cache=3 extcache=4)  [0] ? 3                  
Do you want a new cache partition?  [Yes] : n                         
Enter cache partition  [0] ? 0                                        
Maximum TCP segment size  (Range 512-32768 bytes)  [4096] ?           
Default server TCP connection timeout (Range 5-240 seconds) [120] ?  
Default client TCP connection timeout (Range 5-240 seconds)  [120] ?  
Do you want to modify cache partition [0]?  No :                      
Requested port has been added to cluster 113.3.1.11                  
Maxweight has been set to 20 for port 80 in cluster 113.3.1.11      
Note:The following example applies when port mode 3 (cache=3) is selected and a new cache partition is being added.
NDR Config>add port
Cluster Address [0.0.0.0]? 113.3.1.10
Port number [80]? 
Port type(tcp=1, udp=2, both=3) [3]?
Max. weight (0-100) [20]? 
Only one pftp port per cluster allowed 
Port mode (none=0, sticky=1 pftp=2 cache=3 extcache=4) [0]? 3
Do you want a new cache partition? [Yes]: y 
Default server TCP connection timeout (Range 5-240 seconds) [120]? 
Default client TCP connection timeout (Range 5-240 seconds) [120]? 
Maximum partition size (1-4095 megabytes or 0 for no limit) [0]? 
Maximum number of objects (1-100000 or 0 for no limit) [0]? 
Maximum object size (512-300000 bytes or 0 for no limit) [0]? 
Do you want the cache enabled upon reboot? [Yes]: 
 
Default cache purge interval (1-720 minutes or 0 to disable) [10]? 
Enable transparent caching? [Yes]: 
Check cache control headers? [Yes]: 
Cache images? [Yes]: 
      Default expiration time for images
              (1-10080 minutes or 0 for no expiration) [60]? 
Cache non-image static objects? [Yes]: 
      Default expiration time for non-image static objects
              (1-10080 minutes or 0 for no expiration) [60]? 
URL mask to identify dynamic objects [*/cgi*]? 
Cache dynamic objects? [No]: 
Do you want to add a URL mask? [No]: 
 
Cache partition number 0 has been successfully created.
Requested port has been added to cluster 113.3.1.10
Maxweight has been set to 20 for port 80 in cluster 113.3.1.10
Port Type has been set to Both for port 85 in cluster 113.3.1.10
NDR Config>
 

You must use Network Dispatcher to configure the initial cluster and port for the Web Server Caching feature. Once you have added the cluster and port, configuring the port mode as a cache port, you can then modify and display Web Server Caching configuration parameters at the WEBC Config> prompt.

See *** for information about Network Dispatcher.


Accessing the Web Server Cache Environment

To access the Web Server Cache configuration environment, enter the following command at the Config> prompt.

Config> feature webc
WEBC Config>

Web Server Cache Commands

This section describes the Web Server Cache Configuration commands. Table 18 lists the Web Server Cache configuration commands. These commands specify the Web Server Cache feature parameters. To activate these changes restart the router.

Table 18. Web Server Cache Configuration Commands Summary
 Command   Function 
? (Help) Displays all the commands available for this command level or lists the options for specific commands (if available). See "Getting Help".
 Activate   Activates or reactivates cache partitions, using the latest configuration. 
 Add   Adds a URL mask. 
 Delete   Deletes a URL mask or a partition. 
 List   Lists the caching information. 
 Modify   Modifies the caching information. 
Exit Returns you to the previous command level. See "Exiting a Lower Level Environment".

Activate

Use the activate command to initialize all cache partitions, using the latest configuration.

Syntax:

activate

Example:

WEBC Config>act ?
ACTIVATE all initializes cache partitions, using 
the latest configuration.
 

Add

Use the add command to add a URL mask.

Syntax:

add
urlmask

Example:

WEBC Config>add url
Partition number [0]?  
New URL mask []? *newmask* 
Include or Exclude from cache (i or e) [i]? i
Set default expiration time?  [No]:y   
Default expiration time
        (1-10080 minutes or 0for no expiration) [0]? 20     
The URL mask has been added to cache partition number 0.
Note:To add proxies and partitions, you must use Network Dispatcher and go through the add port or set port commands.

partition number
The partition number for the partition to be added.

Valid Values: any valid partition number

Default Value: 0

new URL mask
The name for the URL mask to be added.

Valid Values: Any valid URL mask

Default Value: none

include or exclude from cache
Specifies whether to include in or exclude the URL from the cache.

Valid Values: i or e

Default Value: i

default expiration time
Specifies the default expiration time in minutes. Zero specifies no expiration time.

Valid Values: 0 to 10080 minutes

Default Value: 0 (no expiration time)

Delete

Use the delete command to delete a URL mask or a partition from the configuration database.

Syntax:

delete
partition
urlmask

partition
The number of the partition to be deleted from a cache.

urlmask
The name of the URL mask to be deleted from a cache.

Example:

WEBC Config>delete url
Partition number [0]? 0                              
URL masks defined : 5 
     1: EXCLUDE '*index*'                                      
     2: EXCLUDE '*comp*'                                       
     3: INCLUDE '*tmp*'                                        
        Default expiration time: 1 minutes                    
     4: INCLUDE '*stat*'                                       
        Default expiration time: 5 minutes                     
     5: INCLUDE '*html*'                                       
        Default expiration time: 1000 minutes (16 hrs 40 mins) 
URL mask number [1]? 5                                   
The URL mask for cache partition number 0 has been deleted.
Note:You must delete all proxies using a partition prior to deleting the partition. To delete a proxy you must use the Network Dispatcher feature and remove the associated port and/or cluster, or change the port mode of the port to something other than cache.

partition number
The partition number of the partition to be deleted.

Valid Values: any valid partition

Default Value: 0

URL mask number
The number of the URL mask to be deleted.

Valid Values: any valid URL mask number.

Default Value: 1

List

Use the list command to list the Web Server Cache information.

Syntax:

list
all
external
partition
proxy
urlmask

all
Lists all the ports, partitions, proxies and masks defined in a cache.

external
Lists the information for the External Cache Control Manager.

partition
Lists the partition numbers in a cache.

proxy
Lists the proxies defined in a cache.

urlmask
List the URL masks defined in a cache.

Example: list all

WEBC Config>list all
Cache Partition 0 
    Cluster address 113.3.1.10, Port 80
 
1 cache partition(s) defined.            

Example: list external

WEBC Config>list ext
External Cache manager : Enabled
Port number            : 82
TCP timeout            : 120 seconds
 

Example: list partition

WEBC Config>list part
Cache Partition 0
Maximum partition size         : 1 MB
Maximum number of objects      : Unlimited
Maximum object size:           : Unlimited
Activate on reboot             : Enabled
Cache purge interval           : 10 minutes
Dynamic URL mask               : '*/cgi*' "
Transparent caching                : Enabled
Check cache control headers        : Disabled
Cache images                       : Disabled
Cache non-image static objects     : Enabled
      Default expiration time      : 60 minutes (1 hrs 0 mins)
Cache dynamic objects              : Disabled
Associated proxies (cluster port)  : (113.3.1.10 80)
                                     
1 cache partition(s) defined.

Example: list url

WEBC Config>list url                                     
Partition number [0]?                                         
URL masks defined : 5                                         
    1: EXCLUDE '*index*'                                      
    2: EXCLUDE '*comp*'                                       
    3: INCLUDE '*tmp*'                                        
       Default expiration time: 1 minutes                     
    4: INCLUDE '*stat*'                                       
       Default expiration time: 2 minutes                     
    5: INCLUDE '*html*'                                       
       Default expiration time: 1000 minutes (16 hrs 40 mins) 

Modify

Use the modify command to modify the Web Server Cache information.

Syntax:

modify
external
partition
proxy
urlmask

external
Allows you to modify the External Cache Control Manager.

partition
Allows you to modify a partition.

proxy
Allows you to modify the proxy

urlmask
Allows you to modify the URL mask.

Example: modify external

WEBC Config>mod ext
External cache manager port number(0 to disable) [82]?
TCP connection timeout (Range 5-240) seconds) [120]? 20
Do you want to modify the encryption key:? [No]? Y
Encryption key should be 16 characters long.
Encryption key (16 characters) in Hex (0-9, a-f, A-F):
Encryption Key again (16 characters) in Hex (0-9, a-f, A-F):
The external cache manager has been modified.
 

external cache manager port number
Specifies the external cache control manager port number to be modified.

Valid Values: 0 to 255

Default Value: 82

TCP connection timeout
Specifies the TCP connection of the external cache control manager to be modified.

Valid Values: 5 to 240 seconds

Default Value: 120

do you want to modify the encryption key
Specifies whether or not to modify the encryption key.

Valid Values: yes or no

Default Value: no

encryption key
The encryption key for the external cache control manager you want to modify. The encryption key must be 16 characters in length and expressed in Hex.

Valid Values: Hex (0-9, a-f, A-F)

Default Value: none

Example: modify partition

WEBC Config>modify partition
Partition number [0] ?                                         
Maximum partition size (1-255 megabytes or 0 for no limit) [0]? 200
Maximum number of objects (1-100000 or 0 for no limit)[0]? 5000  
Maximum object size (512-300000 bytes or 0 for no limit)[0]? 250000 
Do you want the cache enabled upon reboot? [Yes]:
 
Default cache purge interval (1-720 minutes or 0 to disable) [10]? 20
Enable transparent caching? [Yes]:
Check cache control headers? [Yes]:
Cache images? [Yes]:
      Default expiration time for images
              (1-10080 minutes or 0 for no expiration) [60]?
Cache non-image static objects? [Yes]:
      Default expiration time for non-image static objects
              (1-10080 minutes or 0 for no expiration) [60]?
URL mask to identify dynamic objects [*/cgi*]? *dyn*
Cache dynamic objects? [No]: y
Cache partition number 0 has been modified.         

partition number
The number of the partition to be modified.

Valid Values: any valid partition number

Default Value: 0

maximum partition size
The maximum partition size of the partition to be modified. Zero specifies no limit.

Valid Values: 1 to 255 megabytes or 0 for no limit

Default Value: 0

maximum number of objects
The maximum number of objects to be modified in the partition. Zero specifies no limit.

Valid Values: 0 to 100000 or 0 for no limit

Default Value: 0

maximum object size
The maximum size of the object to be modified in the partition. Zero specifies no limit.

Valid Values: 512 to 300000 or 0 for no limit

Default Value: 0

do you want the cache enabled upon reboot
Specifies whether or not to enable the cache after a reboot.

Valid Values: yes or no

Default Value: yes

default cache purge interval
Specifies the default cache purge interval. Zero disables the default cache purge interval.

Valid Values: 1 to 170 minutes or 0 to disable

Default Value: 10

enable transparent caching
Specifies whether or not to enable transparent caching. The alternative is manipulating the cache with the ECCP.

Valid Values: yes or no

Default Value: yes

check cache control headers
Specifies whether or not to check the cache control headers.

Valid Values: yes or no

Default Value: yes

cache images
Specifies whether or not to cache images.

Valid Values: yes or no

Default Value: yes

Default expiration time for images
Specifies the default expiration time for images. Zero for no expiration.

Valid Values: 1 to 10080, or 0 for no expiration

Default Value: 60

cache non-image static objects
Specifies whether or not to cache non-image static objects.

Default Value: yes

Valid Values: yes or no

Default expiration time for non-image static objects
Specifies the default expiration time for non-image static objects. Zero for no expiration.

Valid Values: 1 to 10080, or 0 for no expiration

Default Value: 60

url mask to identify dynamic objects
Specifies the URL mask to use to identify dynamic objects.

Valid Values: any valid url mask

Default Value: */cgi*

cache dynamic objects
Specifies whether or not to cache dynamic objects.

Valid Values: yes or no

Default Value: no

Example: modify url

WEBC Config>modify url
Partition number [0]?                                         
URL masks defined : 5                                         
    1: EXCLUDE '*index*'                                      
    2: EXCLUDE '*comp*'                                       
    3: INCLUDE '*tmp*'                                        
       Default expiration time: 1 minutes                     
    4: INCLUDE '*stat*'                                       
       Default expiration time: 2 minutes                     
    5: INCLUDE '*html*'                                       
       Default expiration time: 1000 minutes (16 hrs 40 mins) 
URL mask number  [1] ? 4                                        
New URL mask *stat*?                                        
Include or Exclude from cache (i or e) [i]?                   
Set default expiration time?  Yes :                           
Default expiration time                                      
        (1-10080 minutes or 0 for no expiration) [2]? 5       
URL mask number 4 has been modified.                          

partition number
Specifies the partition number for the URL to be modified.

Valid Values: any valid partition number

Default Value: 0

url mask number
Specifies the URL mask number of the URL mask to be modified.

Valid Values:any valid URL mask number

Default Value: 1

new url mask *stat*

Valid Values: yes

Default Value: yes or no

include or exclude from cache
Specifies whether or not to include in or exclude the modified URL in the cache.

Valid Values: i or e

Default Value: i

set default expiration time
Specifies whether or not to set the default expiration time.

Valid Values: yes or no

Default Value: yes

default expiration time
Specifies the default expiration time in minutes. Zero specifies no expiration.

Valid Values: 1 to 10080 minutes, or 0 for no expiration.

Default Value:0


Accessing the Web Server Cache Monitoring Environment

To access the Web Server Cache monitoring environment enter f webc at the t 5 config prompt.

t 5>f webc
 

Web Server Cache Monitoring Commands

Table 19 list the Web Server Cache monitoring commands. All of the commands operate against the running system, and do not modify the configuration database. The Activate command uses information from the configuration.

Table 19. Web Server Cache Monitoring Commands Summary
 Command   Function 
? (Help) Displays all the commands available for this command level or lists the options for specific commands (if available). See "Getting Help".
 Activate   Activates or reactivates cache partitions, using the latest configuration. 
 Clear   Clears a partition or statistics. 
 Enable   Enables a partition. 
 Delete   Deletes a partition, proxy or URL mask from the running system. 
 Disable   Disables a partition. 
 List   Lists the caching information. 
 Modify   Modifies the caching information. 
Exit Returns you to the previous command level. See "Exiting a Lower Level Environment".

Activate

Use the activate command to activate all Web Server Cache partitions or a specific partition or proxy.

Syntax:

activate
all
external
partition
proxy

all
Activates or reactivates all defined cache partitions.

external
Activates the External Cache Control Manager.

partition
Activates or reactivates a partition in a cache.

proxy
Activates or reactivates a proxy in a cache.

Example: activate all

WEBC>act all
Cache partitions, must be disabled to reactivate them. 
Do you wish to continue? [No]: y                     
WEBC>                                                 

Example: activate Proxy

WEBC>act pr
                                                  
    1) Cluster address 113.3.1.10, Port 80, Cache partition 0 
    2) Cluster address 113.3.1.10, Port 81, Cache partition 0 
Enter proxy number:  1 ? 1                                    
You are trying to activate an existing proxy.                
Doing this will cause the proxy to be terminated before       
being reactivated.                                            
Do you wish to continue? [No]: yes                           

Clear

Use the clear command to clear a partition or statistics.
Note:Clearing the objects from the partition does not clear the statistics for the partition.

Syntax:

clear
partition
statistics

partition
Clears all the objects out of the partition.

statistics
Clears existing statistics for the partition.

Example:

WEBC>clear partition
Enter partition number: [0]? 
Cache partition 0 must be disabled to clear its contents.
Do you wish to continue? [No]: yes
Do you wish to enable this partition? [Yes]: yes
 

partition number
Specifies the partition number to be cleared.

Valid Values: any valid partition number

Default Value: 0

Enable

Use the enable command to enable a partition in the running system.

Syntax:

enable
partition

Example:

WEBC>enable partition
Enter partition number: [0]? 

partition number
The partition number of the partition to be enabled.

Valid Values: any valid partition number

Default Value: 0

Delete

Use the delete command to delete a partition from the running system. All proxies using the partition are deleted. No changes occur to the configuration database for either proxies or partitions.

Syntax:

delete
partition

partition
Deletes a partition from the cache.

Example:

WEBC>delete partition
Enter partition number: [0]? 0 
WARNING: This will delete partition 0 and free all memory!
Do you wish to continue?  [No] : yes 
WEBC>                                                          

partition number
Specifies the partition number to be deleted.

Valid Values: any valid partition number

Default Value: 0

Disable

Use the disable command to disable a partition in the running system.

Syntax:

disable
partition

partition
Disables a partition.

Example:

WEBC>disable partition
Enter partition number: [0]? 
 

partition number
Specifies the partition number of the partition to be disabled.

Valid Values: any valid partition number

Default Value: 0

List

Use the list command to display the information for all Web Server Caching, a partition, a policy or a proxy.

Syntax:

list
all
delete
depend
external
item
partition
policy
proxy

all
Lists all the partitions, policies, and proxies in a cache.

delete
List the last 100 items deleted from the cache partition.

depend
Lists the dependency table for the partition.

external
Lists the information for the External Cache Control Manager.

item
List the current items and the hit count, in the cache partition.

partition
List the partition information in the cache.

policy
Lists the policy information in the cache.

proxy
Lists the proxy information in the cache.

Example:

WEBC>list all 
Cache Partition 0        Status: Enabled 
     Cluster address: 113.3.1.10  Port 80
1 partition(s) active. 
External Cache Manager Port: 82
         Connection Timeout: 120 seconds
 

Example:

WEBC>list delete
Enter partition number: [0]? 0
Delete Table
URL String -- hit count
=======================
'/abc.html' -- 4
'/soccer.html' -- 2
'/tennis.html' -- 1
'/curling.html' -- 3
 

Example:

WEBC>list depend 
Enter partition number: [0]? 
 
Dependency table for Partition 0 
--------------------------------------
dep: tennis_info
   count of URLs: 2
   URLs:
         tennis_schedule.html
         tennis_roster.html
dep: soccer_info
   count of URLs: 2
   URLs:
         soccer_schedule.html
         soccer_roster.html
dep: roster
   count of URLs: 2
   URLs:
         soccer_roster.html
         tennis_roster.html
dep: schedule
   count of URLs: 2
   URLs:
         soccer_schedule.html
         tennis_schedule.html

Example:

WEBC>list item
Enter partition number: [0]? 0
Current number of items: 5
URL String -- hit count
=======================
'/' -- 2
'/file5k.html' -- 1
'/file4k.html' -- 1
'/file2k.html' -- 3
'/file1k.html' -- 1

Example:

WEBC>li partition 0
Cache Partition 0        Status: Enabled
     Cluster address: 113.3.1.10, Port 80
     Cluster address: 113.3.1.10, Port 81
Partition size: Current - 0 bytes  Highest - 0 bytes   Maximum - Unlimited
Number of objects: Current - 0  Highest - 0 Maximum - Unlimited
Maximum object size: Unlimited
Cache purge interval: 10 minute(s)
Hit ratio: 0%
Total number of hits:  0
Cache Hit Bytes Served: 0
Breakdown of responses for the Cache Hits
 (note: this is based on whether the HTTP Proxy considered it a hit.
  So these counts may not add up to the hit count above)
   Response 200(OK):                0
   Response 203(Non-Authoriative):  0
   Response 206(Partial Content):   0
   Response 300(Multiple Choices):  0
   Response 301(Moved Permanently): 0
   Response 304(Not Modified):      0
   Response 410(Gone):              0
Total number of misses:  0
Cache Miss Bytes Served:  0
Breakdown of responses for the Cache Misses
 (note: this is based on whether the HTTP Proxy got the response
  back through it. In the case of multiple boxes working together
  as a big cache these counts will not add up to the total misses
  if a handoff was done)                                         
   Response 100 Range(Information):         0
   Response 200(OK):                        0
   Response 200 Range(Successful-not 200):  0
   Response 304(Not Modified):              0
   Response 300 Range(Redirection-not 304): 0
   Response 400 Range(Client Error):        0
   Response 500 Range(Server Error):        0
   Response other (not in above):           0 
Object Excluded (Object too large):        0
                (Object expired):          0
                (DONT CACHE header):       0
                (URL Mask excluded):       0
                (Image excluded):          0
                (Static object excluded):  0
                (Dynamic object excluded): 0
                (Cache disabled):          0 
Total number of objects added via ECCM Interface: 0
Total number of objects not added via ECCM Interface but was attempted: 0
Total number of objects replaced via ECCM Interface: 0

Example:

WEBC>li pol
Enter partition number: [0]?               
Transparent caching: Enabled               
Cache Control Headers: Enabled            
Cache images:                   Enabled   
     Default lifetime: 0 minute(s)        
Cache non-image static objects: Enabled   
     Default lifetime: 0 minute(s)         
Cache dynamic objects: Disabled            
Dynamic URL mask: *dyn*                    
URL masks defined:                         
  1: EXCLUDE *index*                       
  2: EXCLUDE *comp*                        
  3: INCLUDE *tmp*                         
      Default expiration time: 1 minutes   
  4: INCLUDE *stat*                        
      Default expiration time: 2 minutes   
  5: INCLUDE *html*
      Default expiration time: 1000 minutes (16 hrs 40 mins)                        

Example: Proxy that is part of a Scalable High Availability Cache (SHAC) array.

WEBC>li pr
    WEBC>li pr
    1)   Cluster address 113.3.3.10, Port 80, Cache Partition 0
    2)   Cluster address 113.3.3.20, Port 80, Cache Partition 0
Enter proxy number: [1]? 1
Proxy 1: assigned to cache partition 0
Cluster address: 113.3.3.10     Port number: 80
Server Connection Timeout: 120 seconds
Client Connection Timeout: 120 seconds
Client connections: 0 current / 2 at highest point
Server connections: 0 current / 2 at highest point
Total cache hits: 0
Total cache misses: 649
Cache misses (object not in cache): 649
             (unsupported method):  0
             (can't send response): 0
             (non-cached request):  0
This Proxy is part of a cache group
  Source IP address for group is: 113.3.3.1
  There are currently 2 Cache(s) in this group
  Below are the Caches in the group:
  113.3.1.1
  113.3.6.1                                             

Example: Proxy that is not part of the SHAC array.

WEBC>li pr
    1)   Cluster address 113.3.1.10, Port 80, Cache Partition 0
    2)   Cluster address 113.3.1.10, Port 81, Cache Partition 0
Enter proxy number:  [1]?                                      
Proxy 1: assigned to cache partition 0                         
Cluster address: 113.3.1.10     Port number: 80                
Server Connection Timeout: 240 seconds                        
Client Connection Timeout: 240 seconds                         
Client connections: 0 current / 0 at highest point            
Server connections: 0 current / 0 at highest point            
Total cache hits: 0                                           
Total cache misses: 0                                         
Cache misses (object not in cache): 0                          
             (unsupported method):  0                          
             (can't send response): 0                          
             (non-cached request):  0
             (invalidation):        0                                                  

Modify

Use the modify command to modify the External Cache Control Manager.

Syntax:

modify
external

Example: modify external

WEBC Config>mod ext
External cache manager port number(0 to disable) [82]?
TCP connection timeout (Range 5-240) seconds) [120]? 20
Do you want to modify the encryption key:? [No]? Y
Encryption key should be 16 characters long.
Encryption key (16 characters) in Hex (0-9, a-f, A-F):
Encryption Key again (16 characters) in Hex (0-9, a-f, A-F):
 

external cache manager port number

TCP connection timeout

do you want to modify the encryption key

encryption key

Web Server Cache Dynamic Reconfiguration Support

This section describes dynamic reconfiguration (DR) as it affects Talk 6 and Talk 5 commands.

CONFIG (Talk 6) Delete Interface

Web Server Cache does not support the CONFIG (Talk 6) delete interface command.

GWCON (Talk 5) Activate Interface

The GWCON (Talk 5) activate interface command is not applicable for Web Server Cache. The Web Server Cache is a feature, not an interface.

GWCON (Talk 5) Reset Interface

The GWCON (Talk 5) reset interface command is not applicable for Web Server Cache. The Web Server Cache is a feature, not an interface.

GWCON (Talk 5) Component Reset Commands

Web Server Cache supports the following Web Server Cache-specific GWCON (Talk 5) reset commands:

GWCON, Feature WEBC, Activate All Command

Description:
This command will read all of the SRAMs for Web Server Cache and make the current runtime environment the same.

Network Effect:
All proxies that were currently active will be terminated (that is, all connections on those proxies will be brought down). If the External Cache Control Manager was running, the 2212 will stop listening for new connections on the current port (that is, the connections to the current port will not go down).

Limitations:

The Web Server Cache must have already been activated (see CONFIG, feature webc, activate).

All Web Server Cache commands are supported by the GWCON, feature webc, activate all command.

GWCON, Feature WEBC, Activate Partition Command

Description:
This command will read all of the SRAMs for this partition and make the current run time environment for the partition be the same.

Network Effect:
If the partition being activated already exists, all the proxies on that partition will be terminated (that is, all connections on those proxies will be brought down).

Limitations:

The following table summarizes the Web Server Cache configuration changes that are activated when the GWCON, feature webc, activate partition command is invoked:
Commands whose changes are activated by the GWCON, feature webc, activate partition command
CONFIG, feature webc, add urlmask
CONFIG, feature webc, delete partition
CONFIG, feature webc, delete urlmask
CONFIG, feature webc, modify partition
CONFIG, feature webc, modify proxy
CONFIG, feature webc, modify urlmask

GWCON, Feature WEBC, Activate Proxy Command

Description:
This command will read all of the SRAMs for this proxy and make the current run time environment for the proxy be the same.

Network Effect:
If the proxy being activated already exists, it will be terminated first (that is, all the connections on the proxy will be brought down).

Limitation:

The Web Server Cache must already have been activated (see CONFIG, feature webc, activate).

The following table summarizes the Web Server Cache configuration changes that are activated when the GWCON, feature webc, activate proxy command is invoked:
Commands whose changes are activated by the GWCON, feature webc, activate proxy command
CONFIG, feature webc, modify proxy

GWCON, Feature WEBC, Activate External Port Command

Description:
This command will read all of the SRAMs for the External Cache Control Manager and make the current runtime environment for the External Cache Control Manager be the same.

Network Effect:
If the External Cache Control Manager was running, the 2212 will stop listening for new connections on the current port (that is, the connections to the current port will not go down).

Limitation:

The Web Server Cache must have already been activated (see CONFIG, feature webc, activate).

The following table summarizes the Web Server Cache configuration changes that are activated when the GWCON, feature webc, activate external port command is invoked:
Commands whose changes are activated by the GWCON, feature webc, activate external port command
CONFIG, feature webc, modify external

CONFIG (Talk 6) Activate Commands

Web Server Cache supports the following CONFIG (Talk 6) activate commands:

CONFIG, Feature WEBC, Activate Command

Description:
Dynamically changes the Web Server Cache currently running based on the current SRAM.

Network Effect:
All proxies that were currently active will be terminated (that is, all connections on those proxies will be brought down). If the External Cache Control Manager was running, the 2212 will stop listening for new connections on the current port (that is, the connections to the current port will not go down).

Limitations:
None.

All Web Server Cache commands are supported by the CONFIG, feature webc, activate command.

GWCON (Talk 5) Temporary Change Commands

Web Server Cache supports the following GWCON commands that temporarily change the operational state of the device. These changes are lost whenever the device is reloaded, restarted, or you execute any dynamically reconfigurable command.
Commands
GWCON, feature webc, modify external
Note:This command will change the current run time environment for the External Cache Control Manager. If the External Cache Control Manager was running, the 2212 will stop listening for new connections on the current port (that is, the connections to the current port will not go down).
GWCON, feature webc, delete partition
Note:This command will delete the partition from the current runtime environment.


[ Top of Page | Previous Page | Next Page | Table of Contents | Index ]